home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / hpgn12.zip / HLPGEN.MAC < prev    next >
Text File  |  1994-09-06  |  50KB  |  1,500 lines
  1. .rem(=================================)
  2. .rem(|  Macro File for HelpGen Help  |)
  3. .rem(|Copyright 1994 Rimrock Software|)
  4. .rem(|     All rights reserved.      |)
  5. .rem(=================================)
  6. .start(main,Contents,HLPGEN.BMP,HelpGen Help)
  7. .top(Help)
  8. .top(Table of Contents)
  9. .n
  10. .b(Purpose) - Click on icon above.n.n
  11. .b(How to).n
  12. .in
  13. ##.j(lodmac,Load or Create a Macro file)
  14. ##.j(crehpj,Load or Create a Project File)
  15. ##.j(bldrtf,Build an RTF File)
  16. ##.j(bldhlp,Build a Help File)
  17. ##.j(lang,Use the HelpGen Macro Language)
  18. .un
  19. .n
  20. .b(Menu Commands).n
  21. .in
  22. ##.j(file,File Commands)
  23. ##.j(edit,Edit Commands)
  24. ##.j(generate,Build Commands)
  25. ##.j(testem,Test Command)
  26. ##.j(options,Option Commands)
  27. ##.j(help,Help Commands)
  28. .un
  29. .n
  30. .bj(glossary,demo.bmp)
  31. \tab
  32. .b(Glossary).n
  33. .n
  34. If you are unfamiliar with how Windows Help works, choose
  35.  .b(Help | How To Use Help) from the Help menu now.
  36. .end
  37. .rem(=================================)
  38. .rem( Icon topic                      )
  39. .rem(=================================)
  40. .ent(icon,Information,HelpGen ) \qc
  41. HelpGen version 1.20.  \'a9 1994 by Rimrock Software, all rights reserved..n.n \ql
  42. Under normal circumstances, if you want to create a help file with 
  43. the Windows help compiler, you must first create a help topic file 
  44. using a word processor that can save files in Rich Text Format (.p1(RTF)). 
  45. There are several basic problems with that approach:.n
  46. .in
  47. #n(1)Word processors cost a lot of money..n
  48. #n(2)Once you've purchased the word processor, you have to 
  49. learn how to use it.  This may not be a very productive use of 
  50. your programming time..n
  51. #n(3)You also have to learn how to use the word processor to 
  52. produce a file that is properly formatted for the help compiler.  
  53. This involves using items like underlining, double-underlining, 
  54. hidden text, footnotes, etc..n
  55. .un
  56. HelpGen eliminates these problems by allowing you to use your 
  57. favorite ASCII text editor to produce a HelpGen .p1(macro) file, which 
  58. HelpGen uses to create the RTF formatted file required by the 
  59. help compiler..n.n
  60. HelpGen automates the entire process of creating help files:.n
  61. .in
  62. ##Creates a skeleton macro file for you to edit.
  63. ##Invokes your editor to allow you to edit the macro file.
  64. ##Creates a help project file (.HPJ) to tell the help 
  65. compiler how to compile the help file.
  66. ##Generates an RTF file from the macro file.
  67. ##Invokes the help compiler to compile the RTF file into a 
  68. HLP file.
  69. ##Allows you to directly test the result..n
  70. .n
  71. .box
  72. The HelpGen macro engine is based on code written by David Spector, and published 
  73. in Windows/DOS Developer's Journal, Vol. 5, No. 7, July 1994.
  74. .bend
  75. .n
  76. This version of HelpGen is a .p1(shareware) evaluation version.  You may use this version 
  77. for up to 60 days to determine whether the program is of use to you.  If you continue 
  78. to use the program beyond that time period, you must register.  Registration of 
  79. HelpGen is $30.
  80. .end
  81. .rem(=================================)
  82. .rem( Load/Create macros topic        )
  83. .rem(=================================)
  84. .ent(lodmac,Load/Create Macro File,How to )
  85. Select the .b(File | Open Macro File) menu option.  Select an existing .MAC file 
  86. or enter the name of a new file.  If you enter the name of a file that does not 
  87. exist, HelpGen will create the file for you, using a .p1(template) that contains the 
  88. minimum items required to build a help file..n
  89. .n
  90. If you have created a new .p1(macro) file, you should use the .b(Edit | Macro File) 
  91. option to make two changes to the file.  The first change is a new title for 
  92. the table of contents.  The default title is xxxx.  The second change is the 
  93. selection of a .BMP graphic to place on the table of contents title line.  The 
  94. default is HlpGen.BMP.
  95. .end
  96. .rem(=================================)
  97. .rem( Load/Create project file topic  )
  98. .rem(=================================)
  99. .ent(crehpj,Load/Create Project File,How to )
  100. HelpGen looks for an associated .p1(project) file when you open the current macro 
  101. file.  If it finds one, HelpGen will enable the .b(Edit | Project File) menu 
  102. item, and you won't have to build a project file.  If it doesn't find a project 
  103. file, HelpGen will enable the .b(Build | Project File) menu item to allow you to 
  104. create a project file.  You must select .b(Build | Project File) to 
  105. create the new project file..n
  106. .n
  107. .box
  108. .b(NOTE:) Before you build a project file, select the .b(Options | Project File) 
  109. menu item and make sure that all the items in that dialog are to your liking.  
  110. Those items will be used to create the project file.
  111. .bend
  112. .end
  113. .rem(=================================)
  114. .rem( how to build RTF file topic     )
  115. .rem(=================================)
  116. .ent(bldrtf,Build an RTF File,How to )
  117. Select the .b(Build | RTF File) menu item.  HelpGen will ask you if you are sure 
  118. you want to create an .p1(RTF) file.  If you answer 'yes', HelpGen will create a .RTF 
  119. file by processing the .MAC file.  Macros will be expanded and .p(rtfcmds,RTF commands) and 
  120. plain text will be passed through to the .RTF file.  When processing is complete, 
  121. HelpGen will tell you and will then enable the .b(Build | HLP File) menu item.
  122. .end
  123. .rem(=================================)
  124. .rem( how to build help file topic    )
  125. .rem(=================================)
  126. .ent(bldhlp,Build a Help File,How to )
  127. Select the .b(Build | HLP File) menu item.  HelpGen will ask you if you are sure 
  128. you want to create a help file.  If you answer 'yes', HelpGen will invoke the 
  129. .p(hlpcmplr,help compiler) you have selected in the .b(Options | Directories) menu item.  This 
  130. will involve shelling out to DOS, since help compilers are DOS programs.  When 
  131. HelpGen gets control again, it will enable the .b(Test) menu item, to allow you 
  132. to test the help file you have just created..n
  133. .n
  134. If there were errors generated during the help compilation, they will be listed in 
  135. the error log file that is shown in .b(Options | Project File)..n
  136. .n
  137. .box
  138. .b(NOTE:) When HelpGen invokes the help compiler, and for some reason the compiler 
  139. can't execute, HelpGen will notify you by displaying an error message.  To possibly 
  140. correct your problem, make sure that the proper help compiler is correctly chosen in 
  141. HelpGen's .b(Options | Directories) menu item.
  142. .bend
  143. .end
  144. .rem(=================================)
  145. .rem( using helpgen TOC topic         )
  146. .rem(=================================)
  147. .ent(lang,Macro Language,Using the HelpGen )
  148. .in
  149. ##.j(langbas,Macro Language Basics)
  150. ##.j(maccmd,Macro Language Commands)
  151. ##.j(rtfcmd,Useful RTF Commands)
  152. .un
  153. .end
  154. .rem(=================================)
  155. .rem( file commands topic             )
  156. .rem(=================================)
  157. .ent(file,File Commands,The )
  158. .in
  159. ##.j(open,Open Macro File)
  160. ##.j(close,Close Macro File)
  161. ##.j(print,Print Macro File)
  162. ##.j(exit,Exit)
  163. .un
  164. .end
  165. .rem(=================================)
  166. .rem( edit commands TOC topic         )
  167. .rem(=================================)
  168. .ent(edit,Edit Commands,The )
  169. .in
  170. ##.j(editmac,Edit Macro File)
  171. ##.j(edithpj,Edit Project File)
  172. .un
  173. .end
  174. .rem(=================================)
  175. .rem( build commands TOC topic        )
  176. .rem(=================================)
  177. .ent(generate,Build Commands,The )
  178. .in
  179. ##.j(genhpj,Project File)
  180. ##.j(genrtf,RTF File)
  181. ##.j(genhlp,HLP File)
  182. .un
  183. .end
  184. .rem(=================================)
  185. .rem( test command topic              )
  186. .rem(=================================)
  187. .ent(testem,Test Command,The )
  188. The .b(Test) menu item allows you to test the help file that you have 
  189. just generated.  It will only be enabled after you have generated a 
  190. help file.
  191. .s
  192. .bmpl(testrtf.bmp)You may also select this menu item with the .p1(toolbar) 
  193. Test Help File button.
  194. .end
  195. .rem(=================================)
  196. .rem( options commands TOC topic      )
  197. .rem(=================================)
  198. .ent(options,Options Commands,The )
  199. .in
  200. ##.j(optdir,Directories)
  201. ##.j(opthpj,Project File)
  202. .un
  203. .end
  204. .rem(=================================)
  205. .rem( help commands TOC topic         )
  206. .rem(=================================)
  207. .ent(help,Help Commands,The )
  208. .in
  209. ##.j(hlpcon,Contents)
  210. ##.j(register,Register HelpGen)
  211. ##.j(about,About HelpGen)
  212. .un
  213. .end
  214. .rem(=================================)
  215. .rem( open macro file topic           )
  216. .rem(=================================)
  217. .ent(open,Open Macro File, )
  218. Open an existing .p1(macro) file, or create a new macro file to be edited 
  219. (.b(File | Open Macro File) menu item).  A check will be made for a 
  220. corresponding .p1(project) file.  If a project file exists, then the 
  221. .b(Edit | Project File) menu item will be enabled.  If a project file does 
  222. not exist, then the .b(Build | Project File) menu item will be enabled.  
  223. The HelpGen .p(titlebar,title bar) is updated to reflect the current macro file name.
  224. .s
  225. .bmpl(openrtf.bmp)You may also select this menu item with the .p1(toolbar) Open 
  226. Macro File button.
  227. .end
  228. .rem(=================================)
  229. .rem( close macro file topic          )
  230. .rem(=================================)
  231. .ent(close,Close Macro File, )
  232. The Close command closes all files and disables all HelpGen menu items that are 
  233. associated with open files (.b(File | Close Macro File) menu item).  The 
  234. HelpGen .p(titlebar,title bar) is updated to show that no .p1(macro) file is currently open.
  235. .s
  236. .bmpl(closertf.bmp)You may also select this menu item with the .p1(toolbar) Close 
  237. Macro File button.
  238. .end
  239. .rem(=================================)
  240. .rem( print macro file topic          )
  241. .rem(=================================)
  242. .ent(print,Print Macro File, )
  243. The Print command will print the current .p1(macro) file on any printer 
  244. (.b(File | Print Macro File) menu item).  You will be asked to select the 
  245. proper printer before any printing takes place.
  246. .s
  247. .bmpl(printrtf.bmp)You may also select this menu item with the .p1(toolbar) Print 
  248. Macro File button.
  249. .end
  250. .rem(=================================)
  251. .rem( exit topic                      )
  252. .rem(=================================)
  253. .ent(exit,Exit to Program Manager, )
  254. The Exit command closes all open files and shuts down the HelpGen program 
  255. (.b(File | Exit) menu item).
  256. .end
  257. .rem(=================================)
  258. .rem( edit macro file topic           )
  259. .rem(=================================)
  260. .ent(editmac,Edit Macro File, )
  261. The .b(Edit | Macro File) command executes a text editor and allows you to make 
  262. changes to the current .p1(macro) file.  The default text editor is NOTEPAD.EXE.  The 
  263. default editor may be changed using the .b(Options | Directories) menu item.
  264. .s
  265. .bmpl(edmacrtf.bmp)You may also select this menu item with the .p1(toolbar) Edit 
  266. Macro File button.
  267. .s
  268. .box
  269. .b(NOTE:) When HelpGen invokes the text editor, and for some reason the editor 
  270. can't be executed, HelpGen will notify you by displaying an error message.  
  271. To possibly correct your problem, make sure that the text editor is correctly 
  272. chosen in HelpGen's Options | Directories menu item.
  273. .bend
  274. .end
  275. .rem(=================================)
  276. .rem( edit project file topic         )
  277. .rem(=================================)
  278. .ent(edithpj,Edit Project File, )
  279. The .b(Edit | Project File) menu item executes a text editor and allows you to make 
  280. changes to the current .p1(project) file.  The default text editor is NOTEPAD.EXE.  The 
  281. default editor may be changed using the .b(Options | Directories) menu item.
  282. .s
  283. .bmpl(edhpjrtf.bmp)You may also select this menu item with the .p1(toolbar) Edit 
  284. Project File button.
  285. .s
  286. .box
  287. .b(NOTE:) When HelpGen invokes the text editor, and for some reason the editor 
  288. can't execute, HelpGen will notify you by displaying an error message.  
  289. To possibly correct your problem, make sure that the text editor is correctly 
  290. chosen in HelpGen's Options | Directories menu item.
  291. .bend
  292. .end
  293. .rem(=================================)
  294. .rem( build project file topic        )
  295. .rem(=================================)
  296. .ent(genhpj,Build Project File, )
  297. If you don't yet have a .p1(project) file for your current .p1(macro) file, this menu 
  298. item will be enabled (.b(Build | Project File) menu item).  It will create 
  299. a project file for you, based on the entries contained in the .b(Options) menu.  
  300. You may then make any changes to this file using the .b(Edit | Project File) 
  301. menu item.  The project file will have the same filename as the macro file, 
  302. with an extension of .HPJ.
  303. .s
  304. .bmpl(buhpjrtf.bmp)You may also select this menu item with the .p1(toolbar) Build 
  305. Project File button.
  306. .end
  307. .rem(=================================)
  308. .rem( build RTF file topic            )
  309. .rem(=================================)
  310. .ent(genrtf,Build RTF File, )
  311. The .b(Build | RTF File) menu item uses the current .p1(macro) file to build a Rich Text 
  312. Format (.p1(RTF)) file of the same name.  The RTF file is used as an input file for 
  313. the .p(hlpcmplr,help compiler).
  314. .s
  315. .bmpl(burtfrtf.bmp)You may also select this menu item with the .p1(toolbar) Build 
  316. RTF File button.
  317. .end
  318. .rem(=================================)
  319. .rem( build HLP file topic            )
  320. .rem(=================================)
  321. .ent(genhlp,Build HLP File, )
  322. The .b(Build | HLP File) menu item uses the current .p1(project) file and the .p1(RTF) file 
  323. created by HelpGen to create a Microsoft Help File (HLP).  It does this by 
  324. invoking the Microsoft (or other) help compiler.  The default help compiler is 
  325. HC31.EXE.  You may change the default help compiler by using the .b(Options | Directories) 
  326. menu item.
  327. .s
  328. .bmpl(buhlprtf.bmp)You may also select this menu item with the .p1(toolbar) Build 
  329. HLP File button.
  330. .s
  331. .box
  332. .b(NOTE:) When HelpGen invokes the help compiler, and for some reason the compiler 
  333. can't execute, HelpGen will notify you by displaying an error message.  To possibly 
  334. correct your problem, make sure that the proper help compiler is correctly chosen in 
  335. HelpGen's Options | Directories menu item.
  336. .bend
  337. .end
  338. .rem(=================================)
  339. .rem( directories options topic       )
  340. .rem(=================================)
  341. .ent(optdir,Directories,Set )
  342. The .b(Options | Directories) menu item allows you to select the .p(hlpcmplr,help compiler) 
  343. and text editor that HelpGen uses when building a help file or editing text.  The 
  344. entries that you make are also saved in HelpGen's .INI file and will be used each 
  345. time you execute HelpGen.
  346. .end
  347. .rem(=================================)
  348. .rem( project file options topic      )
  349. .rem(=================================)
  350. .ent(opthpj,Project File Options,Set )
  351. The .b(Options | Project File) menu item allows you to specify the options that 
  352. will be installed in a .p1(project) file that is created by HelpGen.  Some of these 
  353. options are saved in HelpGen's .INI file, so they may be used in subsequent 
  354. executions of HelpGen.  Specifically, the Compression type, Warnings, Report status, 
  355. Copyright notice and Error Log are all saved in the .INI file..n
  356. .n
  357. .i(Title).n
  358. The Title specifies the string that is placed on the Help File's .p(titlebar,title bar) when the help 
  359. file is executed..n
  360. .n
  361. .i(Copyright).n
  362. The Copyright specifies the string that is placed inside of the help file's About box.
  363. This box is activated by executing the help file and selecting .b(Help | About Help)..n
  364. .n
  365. .i(Error Log).n
  366. The Error Log is the file that the .p(hlpcmplr,help compiler) uses to write error messages to.  If 
  367. you have errors during a help compilation, look at this file to see what the errors 
  368. were..n
  369. .n
  370. .i(Icon File).n
  371. The Icon File entry specifies the icon that will be used when the help file is minimized.  
  372. This entry will override the default question mark icon..n
  373. .n
  374. .i(Bitmap Root).n
  375. The Bitmap Root specifies the directory that is used to store bitmap files, if they 
  376. are not in the current directory..n
  377. .n
  378. .i(Compression).n
  379. The Compression option specifies what type of compression is used when building 
  380. the help file.  .b(0) specifies no compression, .b(Medium) specifies 40% compression 
  381. and .b(High) specifies 50% compression..n
  382. .n
  383. .i(Warnings).n
  384. The Warnings option sets the level of error messages that the help 
  385. compiler will display during compilation. .b(Some) means only the most severe messages will 
  386. be displayed, .b(Many) means a medium amount of error messages will be displayed, 
  387. and .(All) means display all messages..n
  388. .n
  389. .i(Report).n
  390. The Report option determines the type of error messages that are displayed 
  391. during help file compilation.
  392. .end
  393. .rem(=================================)
  394. .rem( help contents topic             )
  395. .rem(=================================)
  396. .ent(hlpcon,Help Contents, )
  397. The .b(Help | Contents) menu item executes the help file you are currently reading.
  398. .s
  399. .bmpl(helprtf.bmp)You may also select this menu item with the .p1(toolbar) Help 
  400. Contents button.
  401. .end
  402. .rem(=================================)
  403. .rem( register helpgen topic          )
  404. .rem(=================================)
  405. .ent(register,Register HelpGen, )
  406. The .b(Help | Register HelpGen) menu item  allows you to fill out entries and print 
  407. a registration form.  The entries will be printed one line after the other.  If any 
  408. entry is missing, that entry will not be printed.
  409. .end
  410. .rem(=================================)
  411. .rem( about helpgen topic             )
  412. .rem(=================================)
  413. .ent(about,About HelpGen, )
  414. The .b(Help | About HelpGen) menu item provides information about the current version 
  415. of the HelpGen program. 
  416. .end
  417. .rem(=================================)
  418. .rem( language basics topic           )
  419. .rem(=================================)
  420. .ent(langbas,Language Basics, )
  421. HelpGen Macro Files consist of distinct blocks of text. These blocks are 
  422. marked by HelpGen .p(macro,macros).  The first block is the \'2estart/\'2eend/\'2eend_file block:.n
  423. .n
  424. .[
  425. \li720
  426. \'2estart(......).n
  427. \tab Table of Contents stuff here.....n
  428. \'2eend.n.n
  429. \tab Rest of macro file goes here.....n.n
  430. \'2eend_file.n
  431. .]
  432. .n
  433. The rest of the macro file is broken up into \'2eent/\'2eend and 
  434. \'2epent/\'2eend blocks:.n
  435. .n
  436. .[
  437. \li720
  438. \'2estart(......).n
  439. \tab Table of Contents stuff here.....n
  440. \'2eend.n.n
  441. \'2eent(.....).n
  442. \tab Topic stuff here.....n
  443. \'2eend.n.n
  444. \'2eent(.....).n
  445. \tab Topic stuff here.....n
  446. \'2eend.n.n
  447. \'2eent(.....).n
  448. \tab Topic stuff here.....n
  449. \'2eend.n.n
  450. \'2epent(.....).n
  451. \tab Popup stuff here.....n
  452. \'2eend.n.n
  453. \'2epent(.....).n
  454. \tab Popup stuff here.....n
  455. \'2eend.n.n
  456. \'2eend_file.n
  457. .]
  458. .n
  459. Note the use of white space to separate the various blocks.  You may 
  460. also separate the blocks with remarks:.n
  461. .n
  462. .[
  463. \li720
  464. \'2erem(===== Beginning of topic 1 =====).n
  465. \'2eent(.....).n
  466. \tab Topic stuff here.....n
  467. \'2eend.n
  468. \'2erem(===== Beginning of topic 2 =====).n
  469. \'2eent(.....).n
  470. \tab Topic stuff here.....n
  471. \'2eend.n
  472. .]
  473. .n
  474. In order to display each of these blocks, you need to have jumps (\'2ej or 
  475. \'2ej1 for the \'2eent/\'2eend blocks and \'2ep or \'2ep1 for the 
  476. \'2epent/\'2eend blocks) somewhere in your macro file.  Since the help 
  477. file begins at the Table of Contents, there should definitely be some 
  478. jumps in that .p1(topic)..n
  479. .n
  480. All the rest of the HelpGen macros are basically window dressing for 
  481. the topic blocks.  See the various macro commands for examples of how 
  482. to use them..n
  483. .n
  484. HelpGen generates an RTF file that specifies four basic text fonts; 
  485. font 0 is MS San Serif, font 1 is Roman, font 2 is Courier and font 3 
  486. is Symbol.  Font 0 is used for topic headers, font 1 is used for 
  487. normal text in a topic and font 2 is used inside of the \'2e[ and 
  488. \'2e] macros.  Font 3 is not currently used..n
  489. .end
  490. .rem(=================================)
  491. .rem( macro commands TOC topic        )
  492. .rem(=================================)
  493. .ent(maccmd,Macro Language Commands, )
  494. .in
  495. ##.j(cmdstr,\'2estart)
  496. ##.j(cmdent,\'2eent)
  497. ##.j(cmdpent,\'2epent)
  498. ##.j(cmdend,\'2eend)
  499. ##.j(cmdj,\'2ej)
  500. ##.j(cmdj1,\'2ej1)
  501. ##.j(cmdp,\'2ep)
  502. ##.j(cmdp1,\'2ep1)
  503. ##.j(cmdbj,\'2ebj)
  504. ##.j(cmdtop,\'2etop)
  505. ##.j(cmdbmp,\'2ebmp)
  506. ##.j(cmdbmpl,\'2ebmpl)
  507. ##.j(cmdbmpr,\'2ebmpr)
  508. ##.j(cmdbox,\'2ebox)
  509. ##.j(cmdbend,\'2ebend)
  510. ##.j(cmdrem,\'2erem)
  511. ##.j(cmdin,\'2ein)
  512. ##.j(cmdun,\'2eun)
  513. ##.j(cmdpp,\'23\'23)
  514. ##.j(cmdpb,\'23b)
  515. ##.j(cmdpn,\'23n)
  516. ##.j(cmdb,\'2eb)
  517. ##.j(cmdi,\'2ei)
  518. ##.j(cmdob,\'2e[)
  519. ##.j(cmdcb,\'2e])
  520. ##.j(cmdn,\'2en)
  521. ##.j(cmds,\'2es)
  522. ##.j(cmdef,\'2eend_file)
  523. .un
  524. .end
  525. .rem(=================================)
  526. .rem( RTF commands TOC topic          )
  527. .rem(=================================)
  528. .ent(rtfcmd,RTF Commands,Some Useful )
  529. .in
  530. ##.j(cmdbrdrdb,\\brdrdb)
  531. ##.j(cmdbrdrs,\\brdrs)
  532. ##.j(cmdbrdrsh,\\brdrsh)
  533. ##.j(cmdbrdrth,\\brdrth)
  534. ##.j(cmdli,\\li)
  535. ##.j(cmdri,\\ri)
  536. ##.j(cmdql,\\ql)
  537. ##.j(cmdqr,\\qr)
  538. ##.j(cmdqj,\\qj)
  539. ##.j(cmdqc,\\qc)
  540. ##.j(cmdtab,\\tab)
  541. ##.j(cmdhh,\\'hh)
  542. .un
  543. .n
  544. .box
  545. .b(NOTE:) All .p(rtfcmds,RTF commands) should be separated from regular 
  546. text by some kind of 'white space'.  This includes a space (' ') or a 
  547. carriage return.
  548. .bend
  549. .end
  550. .rem(=================================)
  551. .rem( start macro topic               )
  552. .rem(=================================)
  553. .ent(cmdstr,\'2estart Macro,The )
  554. .b(SYNTAX:) \'2estart(label,topic,bitmap_file,application_name).n
  555. .n
  556. .b(EXPLANATION:) This .p1(macro) marks the beginning of a macro file.  
  557. It produces an attractive header for the Table of Contents .p1(topic).  
  558. .b(label) and .b(topic) are as described for the \'2eent macro.  
  559. .b(bitmap_file) is the filename of a \'2eBMP file generated by 
  560. a bitmap editor such as Windows Paintbrush.  .b(application_name) 
  561. is the title that will appear in the header of the Table of 
  562. Contents topic.  You must provide a topic entry labeled 'icon' 
  563. which will be jumped to when the user clicks on the icon in the 
  564. Table of Contents header.  The \'2estart statement also requires 
  565. a corresponding \'2eend to indicate the end of the table of contents..n
  566. .n
  567. .b(EXAMPLE:).n.n
  568. .[
  569. \li720
  570. \'2estart(main,Contents,DEMO\'2eBMP,A Help Demonstration).n
  571. This is the table of contents topic. It is ended by the 
  572. next line..n
  573. \'2eend.n
  574. .n
  575. \'2eent(icon,Version,Help File ).n
  576. This is a mandatory topic.  We jump to here when the 
  577. DEMO\'2eBMP icon is clicked..n
  578. \'2eend.n
  579. .n
  580. \'2eend_file.n
  581. .]
  582. .n
  583. .b(SEE ALSO:) .j(cmdef,\'2eend_file)
  584. .end
  585. .rem(=================================)
  586. .rem( ent macro topic                 )
  587. .rem(=================================)
  588. .ent(cmdent,\'2eent Macro,The )
  589. .b(SYNTAX:) \'2eent(label,topic,prefix).n
  590. .n
  591. .b(EXPLANATION:) This .p1(macro) marks the start of a .p1(topic) entry.  
  592. .b(label) is used to refer to the topic in the \'2ej and \'2ej1 
  593. macros, .b(topic) is the name that will appear in 
  594. the topic header and in the Search dialog box; and .b(prefix) is a 
  595. string that will appear as a prefix in the header (if the topic is 
  596. "Frogs" and the prefix is "The", the header will be "The Frogs" but 
  597. the entry in the Search dialog box will be "Frogs").  The prefix can 
  598. be an empty string..n
  599. .n
  600. .b(EXAMPLE:).n
  601. .n
  602. .[
  603. \li720
  604. \'2eent(file,File Commands, ).n
  605. \'2ein.n
  606. \'23\'23\'2ej(open,Open File)\'2en.n
  607. \'2eun.n
  608. \'2eend.n
  609. .n
  610. \'2eent(open,Open File, ).n
  611. This command allows you to open an existing file..n
  612. \'2eend.n.n
  613. .]
  614. .b(SEE ALSO:) .j(cmdend,\'2eend), .j(cmdj,\'2ej), .j(cmdj1,\'2ej1).n
  615. .end
  616. .rem(=================================)
  617. .rem( pent macro topic                )
  618. .rem(=================================)
  619. .ent(cmdpent,\'2epent Macro,The )
  620. .b(SYNTAX:) \'2epent(label,topic).n
  621. .n
  622. .b(EXPLANATION:) This .p1(macro) is identical to \'2eent, except 
  623. that it creates .p1(popup) topic boxes instead of .p1(topic) pages.  
  624. This type of popup box is usually used for definitions.  .b(label) 
  625. is used to refer to the topic in the \'2ep and \'2ep1 macros 
  626. described below.  .b(topic) should match the topic label in 
  627. the corresponding \'2ep or \'2ep1 macro..n
  628. .n
  629. .b(EXAMPLE:).n
  630. .n
  631. .[
  632. \li720
  633. \'2eent(size,Font Size,Changing ).n
  634. This item allows you to change the size of the display font.  The 
  635. new size can be anywhere from 6 \'2ep1(points) to 72 points..n
  636. \'2eend.n
  637. .n
  638. \'2epent(points,Points).n
  639. A sizing standard for text.  There are 72 points to the inch.  
  640. Therefore, 6 points is 6/72" = 1/12"..n
  641. \'2eend.n.n
  642. .]
  643. .b(SEE ALSO:) .j(cmdend,\'2eend), .j(cmdp,\'2ep), .j(cmdp1,\'2ep1).n
  644. .end
  645. .rem(=================================)
  646. .rem( end macro topic                 )
  647. .rem(=================================)
  648. .ent(cmdend,\'2eend Macro,The )
  649. .b(SYNTAX:) \'2eend.n
  650. .n
  651. .b(EXPLANATION:) This .p1(macro) marks the end of a .p1(topic) entry 
  652. that was started with \'2eent or \'2epent..n
  653. .n
  654. .b(EXAMPLE:) See the examples for \'2estart, \'2eent and \'2epent..n
  655. .n
  656. .b(SEE ALSO:) .j(cmdstr,\'2estart), .j(cmdent,\'2eent), .j(cmdpent,\'2epent).n
  657. .end
  658. .rem(=================================)
  659. .rem( j macro topic                   )
  660. .rem(=================================)
  661. .ent(cmdj,\'2ej Macro,The )
  662. .b(SYNTAX:) \'2ej(label,string).n
  663. .n
  664. .b(EXPLANATION:) This .p1(macro) creates an underlined .b(string) and 
  665. uses the string as a jump area.  If the user clicks on a jump area, 
  666. the .p1(topic) represented by .b(label) is shown on the screen..n
  667. .n
  668. .b(EXAMPLE:).n
  669. .n
  670. .[
  671. \li720
  672. \'2eent(layout,Page Layout,The ).n
  673. How to Lay Out.n
  674. \'2es.n
  675. \'2ej(pageno,Page Numbers)\'2en.n
  676. \'2ej1(Headers)\'2en.n
  677. \'2ej1(Footers)\'2en.n
  678. \'2eend.n
  679. .n
  680. \'2eent(pageno,Page Numbers, Laying Out ).n
  681. Text for page number layout goes here..n
  682. \'2eend.n
  683. .n
  684. \'2eent(Headers,Headers,Laying Out ).n
  685. Text for page header layout goes here..n
  686. \'2eend.n
  687. .n
  688. \'2eent(Footers,Footers,Laying Out ).n
  689. Text for page footer layout goes here..n
  690. \'2eend.n.n
  691. .]
  692. .b(SEE ALSO:) .j(cmdent,\'2eent), .j(cmdj1,\'2ej1), .j(cmdbj,\'2ebj).n
  693. .end
  694. .rem(=================================)
  695. .rem( j1 macro topic                  )
  696. .rem(=================================)
  697. .ent(cmdj1,\'2ej1 Macro,The )
  698. .b(SYNTAX:) \'2ej1(label).n
  699. .n
  700. .b(EXPLANATION:) This .p1(macro) is identical to a \'2ej with its 
  701. .b(label) and .b(string) being identical.  This macro is used for 
  702. brevity..n
  703. .n
  704. .b(EXAMPLE:) See the example for the \'2ej command..n
  705. .n
  706. .b(SEE ALSO:) .j(cmdent,\'2eent), .j(cmdj,\'2ej).n
  707. .end
  708. .rem(=================================)
  709. .rem( p macro topic                   )
  710. .rem(=================================)
  711. .ent(cmdp,\'2ep Macro,The )
  712. .b(SYNTAX:) \'2ep(label,string).n
  713. .n
  714. .b(EXPLANATION:) This .p1(macro) underlines .b(string) with a dotted 
  715. line and uses it as a jump area.  If the user clicks on the jump area, 
  716. the topic represented by .b(label) is shown in a .p1(popup) window.  
  717. This is used to show definitions..n
  718. .n
  719. .b(EXAMPLE:).n
  720. .n
  721. .[
  722. \li720
  723. \'2eent(cmds,Keyboard Commands,New ).n
  724. The keyboard that supports Chicago has three extra keys; the 
  725. \'2ep1(LWIN) key, the \'2ep1(RWIN) key and the \'2ep(application,APP) key..n
  726. \'2eend.n
  727. .n
  728. \'2epent(application,APP).n
  729. When pressed, brings up the context menu at the current select 
  730. position..n
  731. \'2eend.n
  732. .n
  733. \'2epent(LWIN,LWIN).n
  734. Sets the focus to the Chicago User Interface.  Same 
  735. functionality as the RWIN key, but uses a different 
  736. scan code..n
  737. \'2eend.n
  738. .n
  739. \'2epent(RWIN,RWIN).n
  740. Sets the focus to the Chicago User Interface.  Same 
  741. functionality as the LWIN key, but uses a different 
  742. scan code..n
  743. \'2eend.n.n
  744. .]
  745. .b(SEE ALSO:) .j(cmdpent,\'2epent), .j(cmdp1,\'2ep1).n
  746. .end
  747. .rem(=================================)
  748. .rem( p1 macro topic                  )
  749. .rem(=================================)
  750. .ent(cmdp1,\'2ep1 Macro,The )
  751. .b(SYNTAX:) \'2ep1(label).n
  752. .n
  753. .b(EXPLANATION:)  This .p1(macro) is identical to \'2ep with its 
  754. .b(label) and .b(string) being identical.  This macro can be used 
  755. for brevity..n
  756. .n
  757. .b(EXAMPLE:) See the example for the \'2ep command..n
  758. .n
  759. .b(SEE ALSO:) .j(cmdpent,\'2epent), .j(cmdp,\'2ep).n
  760. .end
  761. .rem(=================================)
  762. .rem( bj macro topic                  )
  763. .rem(=================================)
  764. .ent(cmdbj,\'2ebj Macro,The )
  765. .b(SYNTAX:) \'2ebj(label,bitmap_name).n
  766. .n
  767. .b(EXPLANATION:)  This .p1(macro) is creates a graphical jump area 
  768. using .b(bitmap_name) as the graphic.  If the user clicks on the 
  769. jump area, the topic represented by .b(label) is shown on the screen..n
  770. .n
  771. .b(EXAMPLE:).n
  772. .n
  773. .[
  774. \li720
  775. \'2eent(filecmds,File Commands, ).n
  776. \'2ebj(new,new\'2ebmp) New File.n
  777. \'2ebj(open,open\'2ebmp) Open File.n
  778. \'2ebj(close,close\'2ebmp) Close File.n
  779. \'2eend.n
  780. .n
  781. \'2eent(new,New File, ).n
  782. Text for new file command goes here..n
  783. \'2eend.n
  784. .n
  785. \'2eent(open,Open File, ).n
  786. Text for open file command goes here..n
  787. \'2eend.n
  788. .n
  789. \'2eent(close,Close File, ).n
  790. Text for close file command goes here..n
  791. \'2eend.n
  792. .n
  793. .]
  794. .b(SEE ALSO:) .j(cmdent,\'2eent), .j(cmdj,\'2ej).n
  795. .end
  796. .rem(=================================)
  797. .rem( top macro topic                 )
  798. .rem(=================================)
  799. .ent(cmdtop,\'2etop Macro,The )
  800. .b(SYNTAX:) \'2etop(string).n
  801. .n
  802. .b(EXPLANATION:) This .p1(macro) is used inside of \'2eent and \'2epent 
  803. entries to add .b(string) as another associated topic name to the 
  804. Search dialog box..n
  805. .n
  806. .b(EXAMPLE:).n
  807. .n
  808. .[
  809. \li720
  810. \'2epent(mouse,Pointing Devices).n
  811. \'2etop(Trackball).n
  812. \'2etop(Graphics Tablet).n
  813. \'2etop(Mouse).n
  814. \'2etop(Pointing Stick).n
  815. \'2etop(Joy Stick).n
  816. A device that moves the graphical cursor around the 
  817. screen and that allows you to select objects..n
  818. \'2eend.n.n
  819. .]
  820. .b(SEE ALSO:) .j(cmdent,\'2eent), .j(cmdpent,\'2epent).n
  821. .end
  822. .rem(=================================)
  823. .rem( bmp macro topic                 )
  824. .rem(=================================)
  825. .ent(cmdbmp,\'2ebmp Macro,The )
  826. .b(SYNTAX:) \'2ebmp(pathname).n
  827. .n
  828. .b(EXPLANATION:)  This .p1(macro) inserts a named \'2eBMP bitmap 
  829. file on the current line.  The bitmap is positioned as though it 
  830. were just another character..n
  831. .n
  832. .b(EXAMPLE:).n
  833. .n
  834. .[
  835. \li720
  836. \'2eent(open,Open Macro File, ).n
  837. Use the \'2ebmp(openrtf\'2ebmp) Open Macro File button to open the file..n
  838. \'2eend.n.n
  839. .]
  840. .b(SEE ALSO:) .j(cmdbmpl,\'2ebmpl), .j(cmdbmpr,\'2ebmpr).n
  841. .end
  842. .rem(=================================)
  843. .rem( bmpl macro topic                )
  844. .rem(=================================)
  845. .ent(cmdbmpl,\'2ebmpl Macro,The )
  846. .b(SYNTAX:) \'2ebmpl(pathname).n
  847. .n
  848. .b(EXPLANATION:) This .p1(macro) inserts a named \'2eBMP bitmap 
  849. file at the far left side of the current line.  Any text following 
  850. the \'2ebmpl entry is wrapped around the bitmap..n
  851. .n
  852. .b(EXAMPLE:).n
  853. .n
  854. .[
  855. \li720
  856. \'2eent(close,Close Macro File, ).n
  857. \'2ebmpl(closertf\'2ebmp)Close the macro file and all associated 
  858. files.  Disable any menu items relating to open files..n
  859. \'2eend.n.n
  860. .]
  861. .b(SEE ALSO:) .j(cmdbmp,\'2ebmp), .j(cmdbmpr,\'2ebmpr).n
  862. .end
  863. .rem(=================================)
  864. .rem( bmpr macro topic                )
  865. .rem(=================================)
  866. .ent(cmdbmpr,\'2ebmpr Macro,The )
  867. .b(SYNTAX:) \'2ebmpr(pathname).n
  868. .n
  869. .b(EXPLANATION:) This .p1(macro) inserts a named \'2eBMP bitmap 
  870. file at the far right side of the current line.  Any text following 
  871. the \'2ebmpr entry is wrapped around the bitmap..n
  872. .n
  873. .b(EXAMPLE:).n
  874. .n
  875. .[
  876. \li720
  877. \'2eent(keydisp,Key Information,Display ).n
  878. \'2ebmpr(keydisp\'2ebmp)The key display area shows 
  879. the scan codes that will be sent for this particular 
  880. key - unshifted, shifted, control and alternate..n
  881. \'2eend.n.n
  882. .]
  883. .b(SEE ALSO:) .j(cmdbmp,\'2ebmp), .j(cmdbmpl,\'2ebmpl).n
  884. .end
  885. .rem(=================================)
  886. .rem( box macro topic                 )
  887. .rem(=================================)
  888. .ent(cmdbox,\'2ebox Macro,The )
  889. .b(SYNTAX:) \'2ebox.n
  890. .n
  891. .b(EXPLANATION:) This .p1(macro) draws a box around the current 
  892. paragraph.  It applies to all subsequent paragraphs up to the 
  893. \'2ebend command.  Box drawing should only be done in normal 
  894. text areas in \'2eent or \'2epent areas..n
  895. .n
  896. .b(EXAMPLE:).n
  897. .n
  898. .[
  899. \li720
  900. \'2eent(about,About HelpGen, ).n
  901. Display a box containing version information and 
  902. copyright information..n
  903. \'2en.n
  904. \'2ebox.n
  905. \'2eb(NOTE:) The integer portion of the version number 
  906. indicates a major revision and the decimal portion 
  907. indicates a minor revision..n
  908. \'2ebend.n
  909. \'2es.n
  910. All dialog boxes use icon-style pushbuttons and 
  911. graphical elements..n
  912. \'2eend.n.n
  913. .]
  914. .b(SEE ALSO:) .j(cmdbend,\'2ebend).n
  915. .end
  916. .rem(=================================)
  917. .rem( bend macro topic                )
  918. .rem(=================================)
  919. .ent(cmdbend,\'2ebend Macro,The )
  920. .b(SYNTAX:) \'2ebend.n
  921. .n
  922. .b(EXPLANATION:) This .p1(macro) completes the box drawing that was 
  923. started with a \'2ebox command..n
  924. .n
  925. .b(EXAMPLE:) See the \'2ebox example..n
  926. .n
  927. .b(SEE ALSO:) .j(cmdbox,\'2ebox).n
  928. .end
  929. .rem(=================================)
  930. .rem( rem macro topic                 )
  931. .rem(=================================)
  932. .ent(cmdrem,\'2erem Macro,The )
  933. .b(SYNTAX:) \'2erem(text).n
  934. .n
  935. .b(EXPLANATION:) This .p1(macro) allows comments to be inserted 
  936. into the macro file..n
  937. .n
  938. .b(EXAMPLE:).n
  939. .n
  940. .[
  941. \li720
  942. \'2erem(-----------------------------------------------).n
  943. \'2erem( Macro file for RENAULT.EXE help).n
  944. \'2erem(-----------------------------------------------).n
  945. \'2estart(main,Contents,renault\'2ebmp,Renault Help).n
  946. \'2erem(Insert table of Contents here).n
  947. \'2eend.n
  948. \'2eend_file.n.n
  949. .]
  950. .b(SEE ALSO:).n
  951. .end
  952. .rem(=================================)
  953. .rem( in macro topic                  )
  954. .rem(=================================)
  955. .ent(cmdin,\'2ein Macro,The )
  956. .b(SYNTAX:) \'2ein.n
  957. .n
  958. .b(EXPLANATION:) This .p1(macro) starts an indented text section, 
  959. which usually contains a list of items.  The indented section is 
  960. a hanging indent, which means that the first line is indented less 
  961. than the following lines.  Each beginning line will look good if 
  962. it begins with either a number or a bullet..n
  963. .n
  964. .b(EXAMPLE:).n
  965. .n
  966. .[
  967. \li720
  968. \'2eent(sellcars,Sell Cars,How to ).n
  969. \'2ein.n
  970. \'23n(1)Find a customer.\'2en.n
  971. \'23n(2)Convince them this is the car of their dreams, no matter 
  972. how bad it is.\'2en.n
  973. \'23n(3)Close the sale.  Get their John Hancock on the bottom line.\'2en.n
  974. \'2eun.n
  975. \'2eend.n.n
  976. .]
  977. .b(SEE ALSO:) .j(cmdun,\'2eun), .j(cmdpp,\'23\'23), .j(cmdpb,\'23b), .j(cmdpn,\'23n).n
  978. .end
  979. .rem(=================================)
  980. .rem( un macro topic                  )
  981. .rem(=================================)
  982. .ent(cmdun,\'2eun Macro,The )
  983. .b(SYNTAX:) \'2eun.n
  984. .n
  985. .b(EXPLANATION:) This .p1(macro) ends ('unindents') an indented text 
  986. section..n
  987. .n
  988. .b(EXAMPLE:) See the example for the \'2ein command..n
  989. .n
  990. .b(SEE ALSO:) .j(cmdin,\'2ein).n
  991. .end
  992. .rem(=================================)
  993. .rem( pound pound macro topic         )
  994. .rem(=================================)
  995. .ent(cmdpp,\'23\'23 Macro,The )
  996. .b(SYNTAX:) \'23\'23.n
  997. .n
  998. .b(EXPLANATION:) This .p1(macro) represents a bullet for a list 
  999. item.  It should be followed immediately by text..n
  1000. .n
  1001. .b(EXAMPLE:).n
  1002. .n
  1003. .[
  1004. \li720
  1005. \'2eent(advantages,Quilt Advantages, ).n
  1006. \'2es.n
  1007. \'23\'23Uses no electricity.\'2en.n
  1008. \'23\'23All natural construction.\'2en.n
  1009. \'23\'23Reduces number of blankets needed.\'2en.n
  1010. \'2eend.n.n
  1011. .]
  1012. .b(SEE ALSO:) .j(cmdun,\'2eun), .j(cmdpb,\'23b), .j(cmdpn,\'23n).n
  1013. .end
  1014. .rem(=================================)
  1015. .rem( pound b macro topic             )
  1016. .rem(=================================)
  1017. .ent(cmdpb,\'23b Macro,The )
  1018. .b(SYNTAX:) \'23b(text).n
  1019. .n
  1020. .b(EXPLANATION:) This .p1(macro) represents a list item that starts 
  1021. with a bullet and with the given .b(text) in boldface.  It should 
  1022. be followed immediately by text..n
  1023. .n
  1024. .b(EXAMPLE:).n
  1025. .n
  1026. .[
  1027. \li720
  1028. \'2eent(glossary,Glossary, Keyboard ).n
  1029. \'2es.n
  1030. \'23b(Autorepeat)If held down a key will begin to send 
  1031. its code repeatedly.\'2en.n
  1032. \'23b(Mode key)Modifier keys, used in conjunction with normal 
  1033. keys.  Includes shift, control and alternate.\'2en.n
  1034. \'23b(Scan code)A byte value or values sent to the computer.\'2en.n
  1035. \'2eend.n.n
  1036. .]
  1037. .b(SEE ALSO:) .j(cmdun,\'2eun), .j(cmdpp,\'23\'23), .j(cmdpn,\'23n).n
  1038. .end
  1039. .rem(=================================)
  1040. .rem( pound n macro topic             )
  1041. .rem(=================================)
  1042. .ent(cmdpn,\'23n Macro,The )
  1043. .b(SYNTAX:) \'23n(1).n
  1044. .n
  1045. .b(EXPLANATION:) This .p1(macro) represents a numbered list item.  
  1046. It should be followed immediately by text..n
  1047. .n
  1048. .b(EXAMPLE:) See the example for the \'2ein command..n
  1049. .n
  1050. .b(SEE ALSO:) .j(cmdun,\'2eun), .j(cmdpp,\'23\'23), .j(cmdpb,\'23b).n
  1051. .end
  1052. .rem(=================================)
  1053. .rem( b macro topic                   )
  1054. .rem(=================================)
  1055. .ent(cmdb,\'2eb Macro,The )
  1056. .b(SYNTAX:) \'2eb(string).n
  1057. .n
  1058. .b(EXPLANATION:) This .p1(macro) presents the given .b(string) in 
  1059. bold face type..n
  1060. .n
  1061. .b(EXAMPLE:).n
  1062. .n
  1063. .[
  1064. \li720
  1065. \'2eent(startup,Engine Startup, ).n
  1066. Always ensure there is no gas fume build-up in 
  1067. the bilge. \'2eb(THIS IS VERY IMPORTANT.)\'2en.n
  1068. Switch on the ignition and press the start button.\'2en.n
  1069. \'2eend.n.n
  1070. .]
  1071. .b(SEE ALSO:) .j(cmdi,\'2ei).n
  1072. .end
  1073. .rem(=================================)
  1074. .rem( i macro topic                   )
  1075. .rem(=================================)
  1076. .ent(cmdi,\'2ei Macro,The )
  1077. .b(SYNTAX:) \'2ei(string).n
  1078. .n
  1079. .b(EXPLANATION:) This .p1(macro) presents the given .b(string) in 
  1080. italic type..n
  1081. .n
  1082. .b(EXAMPLE:).n
  1083. .n
  1084. .[
  1085. \li720
  1086. \'2eent(chars,Characters,Game ).n
  1087. Your opponents in the game consist of \'2ei(trolls), 
  1088. rabid \'2ei(dogs) and defenseless \'2ei(kittens)..n
  1089. \'2eend.n.n
  1090. .]
  1091. .b(SEE ALSO:) .j(cmdb,\'2eb).n
  1092. .end
  1093. .rem(=================================)
  1094. .rem( [ macro topic                   )
  1095. .rem(=================================)
  1096. .ent(cmdob,\'2e[ Macro,The )
  1097. .b(SYNTAX:) \'2e[.n
  1098. .n
  1099. .b(EXPLANATION:) This .p1(macro) marks the beginning of a region of text 
  1100. that will appear in a bold, fixed-width font.  This is suitable for 
  1101. showing program examples or tables.  NOTE: Since 
  1102. .p1(RTF) files use the open and close curly braces as part of their 
  1103. syntax, if you want to display them in your help file, you must 
  1104. 'escape' them by putting a backslash in front of them.  This is shown 
  1105. in the example below..n
  1106. .n
  1107. .b(EXAMPLE:).n
  1108. .n
  1109. .[
  1110. \li720
  1111. \'2eent(progctl,Control,Program ).n
  1112. The program is controlled with a message router:.n
  1113. \'2es.n
  1114. \'2ein.n
  1115. \'2e[.n
  1116. switch(wParam)\'2en.n
  1117. \\\{\'2en.n
  1118. \\tab case ID_OPEN: . . . \'2en.n
  1119. \\tab \\tab break;\'2en.n
  1120. \\tab case ID_CLOSE: . . . \'2en.n
  1121. \\tab \\tab break;\'2en.n
  1122. \\\}\'2en.n
  1123. \'2e].n
  1124. \'2eun.n
  1125. \'2eend.n.n
  1126. .]
  1127. .b(SEE ALSO:) .j(cmdcb,\'2e]).n
  1128. .end
  1129. .rem(=================================)
  1130. .rem( ] macro topic                   )
  1131. .rem(=================================)
  1132. .ent(cmdcb,\'2e] Macro,The )
  1133. .b(SYNTAX:) \'2e].n
  1134. .n
  1135. .b(EXPLANATION:) This .p1(macro) marks the end of a region that was started with \'2e[.  There should be a \'2e] for 
  1136. every \'2e[..n
  1137. .n
  1138. .b(EXAMPLE:) See the example for the \'2e[ command..n
  1139. .n
  1140. .b(SEE ALSO:) .j(cmdob,\'2e[).n
  1141. .end
  1142. .rem(=================================)
  1143. .rem( n macro topic                   )
  1144. .rem(=================================)
  1145. .ent(cmdn,\'2en Macro,The )
  1146. .b(SYNTAX:) \'2en.n
  1147. .n
  1148. .b(EXPLANATION:) This .p1(macro) is used at the end of a line, or on a line of its own, to indicate the actual end 
  1149. of the line.  When \'2en is not used, separate lines are simply run together and used to fill whatever WinHelp 
  1150. window width the user has chosen..n
  1151. .n
  1152. .b(EXAMPLE:).n
  1153. .n
  1154. .[
  1155. \li720
  1156. \'2eent(drjnk,Health,To Your ).n
  1157. This sentence will adjust itself to the.n
  1158. width of the help window, since there is no.n
  1159. \\'2en at the end of each line.\'2en\'2en.n.n
  1160. This sentence will not adjust itself,\'2en.n
  1161. since there is a \\'2en at the end of\'2en.n
  1162. each line.\'2en.n
  1163. \'2eend.n.n
  1164. .]
  1165. .b(SEE ALSO:) .j(cmds,\'2es).n
  1166. .end
  1167. .rem(=================================)
  1168. .rem( s macro topic                   )
  1169. .rem(=================================)
  1170. .ent(cmds,\'2es Macro,The )
  1171. .b(SYNTAX:) \'2es.n
  1172. .n
  1173. .b(EXPLANATION:) This .p1(macro) is used between lines to skip a space.  If \'2es is used, then don't use \'2en.
  1174. .n
  1175. .b(EXAMPLE:).n
  1176. .n
  1177. .[
  1178. \li720
  1179. \'2eent(morjnk,Health,To My ).n
  1180. This paragraph will be printed with the appropriate.n
  1181. word wrapping and line wrapping. All parts of the.n
  1182. paragraph will remain connected..n
  1183. \'2es.n
  1184. The \'2es above will separate this paragraph from.n
  1185. the preceeding paragraph.  The separation is slightly.n
  1186. more than a single line spacing..n
  1187. \'2eend.n.n
  1188. .]
  1189. .b(SEE ALSO:) .j(cmdn,\'2en).n
  1190. .end
  1191. .rem(=================================)
  1192. .rem( end_file macro topic            )
  1193. .rem(=================================)
  1194. .ent(cmdef,\'2eend_file Macro,The )
  1195. .b(SYNTAX:) \'2eend_file.n
  1196. .n
  1197. .b(EXPLANATION:) This .p1(macro) marks the end of the macro file..n
  1198. .n
  1199. .b(EXAMPLE:) See the example for the \'2estart command..n
  1200. .n
  1201. .b(SEE ALSO:) .j(cmdstr,\'2estart).n
  1202. .end
  1203. .rem(=================================)
  1204. .rem( brdrdb command topic            )
  1205. .rem(=================================)
  1206. .ent(cmdbrdrdb,\\brdrdb Command,The )
  1207. .b(EXPLANATION:) This command changes the border line style to a double line.  It is used as a modifier to 
  1208. the \'2ebox command..n
  1209. .n
  1210. .b(EXAMPLE:).n
  1211. .n
  1212. .[
  1213. \li720
  1214. \'2ebox.n
  1215. \\brdrdb.n
  1216. This text will be displayed in a box with a double line border..n
  1217. \'2ebend.n
  1218. .]
  1219. .end
  1220. .rem(=================================)
  1221. .rem( brdrs command topic             )
  1222. .rem(=================================)
  1223. .ent(cmdbrdrs,\\brdrs Command,The )
  1224. .b(EXPLANATION:) This command  changes the border line style to a single line (this is the default).  It is 
  1225. used as a modifier to the \'2ebox command..n
  1226. .n
  1227. .b(EXAMPLE:).n
  1228. .n
  1229. .[
  1230. \li720
  1231. \'2ebox.n
  1232. \\brdrth.n
  1233. This text will be displayed in a box with a thick border..n
  1234. \\brdrs.n
  1235. And this text will be displayed in a another box with a single 
  1236. line border..n
  1237. \'2ebend.n
  1238. .]
  1239. .end
  1240. .rem(=================================)
  1241. .rem( brdrsh command topic            )
  1242. .rem(=================================)
  1243. .ent(cmdbrdrsh,\\brdrsh Command,The )
  1244. .b(EXPLANATION:) This command changes the border line style to shaded style.  It is used as a modifier to 
  1245. the \'2ebox command..n
  1246. .n
  1247. .b(EXAMPLE:).n
  1248. .n
  1249. .[
  1250. \li720
  1251. \'2ebox.n
  1252. \\brdrsh.n
  1253. This text will be displayed in a box with a shaded border..n
  1254. \'2ebend.n
  1255. .]
  1256. .end
  1257. .rem(=================================)
  1258. .rem( brdrth command topic            )
  1259. .rem(=================================)
  1260. .ent(cmdbrdrth,\\brdrth Command,The )
  1261. .b(EXPLANATION:) This command changes the border line style to a thick line.  It is used as a modifier to 
  1262. the \'2ebox command..n
  1263. .n
  1264. .b(EXAMPLE:) See the example for the \\brdrs command..n
  1265. .n
  1266. .end
  1267. .rem(=================================)
  1268. .rem( li command topic                )
  1269. .rem(=================================)
  1270. .ent(cmdli,\\li Command,The )
  1271. .b(EXPLANATION:) This command changes the left margin indentation to the value that 
  1272. immediately follows the command.  The value is expressed in .p1(twips).  
  1273. To reset the margin to its default, use \\li180..n
  1274. .n
  1275. .b(EXAMPLE:).n
  1276. .n
  1277. \'2e[.n
  1278. \\li720.n
  1279. \\ri720.n
  1280. This sentence will be indented on the left and right margins by 
  1281. 720/1440 = 1/2"..n
  1282. \'2e].n
  1283. \\li180.n
  1284. \\ri180.n
  1285. .end
  1286. .rem(=================================)
  1287. .rem( ri command topic                )
  1288. .rem(=================================)
  1289. .ent(cmdri,\\ri Command,The )
  1290. .b(EXPLANATION:) This command changes the right margin indentation to the value that 
  1291. immediately follows the command.  The value is expressed in .p1(twips).  
  1292. To reset the margin to its default, use \\ri180..n
  1293. .n
  1294. .b(EXAMPLE:) See the example for the \\li command..n
  1295. .end
  1296. .rem(=================================)
  1297. .rem( ql command topic                )
  1298. .rem(=================================)
  1299. .ent(cmdql,\\ql Command,The )
  1300. .b(EXPLANATION:) This command changes the paragraph style to left justified.  This is the default 
  1301. paragraph style..n
  1302. .n
  1303. .b(EXAMPLE:).n
  1304. .n
  1305. .[
  1306. \li720
  1307. \\qc.n
  1308. This paragraph will have every line centered in the 
  1309. help window..n
  1310. \'2es.n
  1311. \\ql.n
  1312. Now we are back to the default left justified paragraph..n
  1313. .]
  1314. .end
  1315. .rem(=================================)
  1316. .rem( qr command topic                )
  1317. .rem(=================================)
  1318. .ent(cmdqr,\\qr Command,The )
  1319. .b(EXPLANATION:) This command changes the paragraph style to right justified..n
  1320. .n
  1321. .b(EXAMPLE:).n
  1322. .n
  1323. .[
  1324. \li720
  1325. This paragraph is normally left justified..n
  1326. \'2es.n
  1327. \\qr.n
  1328. And this paragraph is right justified..n
  1329. \'2es.n
  1330. .]
  1331. .end
  1332. .rem(=================================)
  1333. .rem( qj command topic                )
  1334. .rem(=================================)
  1335. .ent(cmdqj,\\qj Command,The )
  1336. .b(EXPLANATION:) This command changes the paragraph style to fully justified..n
  1337. .n
  1338. .b(EXAMPLE:).n
  1339. .n
  1340. .[
  1341. \li720
  1342. \\qj.n
  1343. The quick brown fox normally jumps over the lazy dog's 
  1344. back in a fully justified fashion..n
  1345. \'2es.n
  1346. .]
  1347. .end
  1348. .rem(=================================)
  1349. .rem( qc command topic                )
  1350. .rem(=================================)
  1351. .ent(cmdqc,\\qc Command,The )
  1352. .b(EXPLANATION:) This command changes the paragraph style to centered lines..n
  1353. .n
  1354. .b(EXAMPLE:) See the example for the \\ql command..n
  1355. .n
  1356. .end
  1357. .rem(=================================)
  1358. .rem( tab command topic               )
  1359. .rem(=================================)
  1360. .ent(cmdtab,\\tab Command,The )
  1361. .b(EXPLANATION:) This command places a tab character in the macro and in the generated RTF file..n
  1362. .n
  1363. .b(EXAMPLE:) See the example for the \'2e[ macro language command..n
  1364. .n
  1365. .end
  1366. .rem(=================================)
  1367. .rem( 'hh command topic               )
  1368. .rem(=================================)
  1369. .ent(cmdhh,\\'hh Command,The )
  1370. .b(EXPLANATION:) This command allows you to put extended characters into a help file.  Some commonly 
  1371. used extended characters are.n
  1372. .n
  1373. \tab\\'a9  =>  \'a9.n
  1374. \tab\\'ae  =>  \'ae.n
  1375. \tab\\'bc  =>  \'bc.n
  1376. \tab\\'bd  =>  \'bd.n
  1377. \tab\\'be  =>  \'be.n
  1378. \tab\\'99  =>  \'99  (trademark symbol. This one may not work correctly, depending on the help compiler).n
  1379. .n
  1380. .b(EXAMPLE:).n
  1381. .n
  1382. .[
  1383. \li720
  1384. \\'a9 1994 Rimrock Software.  All rights reserved.\'2en.n
  1385. Distributed on 3\\'bd double density floppy disk..n
  1386. .]
  1387. .end
  1388. .rem(=================================)
  1389. .rem( glossary topic                  )
  1390. .rem(=================================)
  1391. .ent(glossary,Glossary, )
  1392. .in
  1393. ##.p(hlpcmplr,help compiler)
  1394. ##.p1(macro)
  1395. ##.p1(popup)
  1396. ##.p1(project)
  1397. ##.p1(RTF)
  1398. ##.p(rtfcmds,RTF commands)
  1399. ##.p1(shareware)
  1400. ##.p1(template)
  1401. ##.p(titlebar,title bar)
  1402. ##.p1(toolbar)
  1403. ##.p1(topic)
  1404. ##.p1(twips)
  1405. .un
  1406. .end
  1407. .rem(=================================)
  1408. .rem( macro popup                     )
  1409. .rem(=================================)
  1410. .pent(macro,macro, )
  1411. The replacement of a long series of .p1(RTF) commands with a single 
  1412. command word and (optional) series of arguments.
  1413. .end
  1414. .rem(=================================)
  1415. .rem( shareware popup                 )
  1416. .rem(=================================)
  1417. .pent(shareware,shareware, )
  1418. A software distribution method.  Software is distributed for trial 
  1419. use, and if users find it useful, they are expected to pay a 
  1420. registration fee ('try before you buy').
  1421. .end
  1422. .rem(=================================)
  1423. .rem( template popup                  )
  1424. .rem(=================================)
  1425. .pent(template,template, )
  1426. A series of text lines that constitute the minimal macro 
  1427. file that will convert to an RTF file and compile to a 
  1428. help file.
  1429. .end
  1430. .rem(=================================)
  1431. .rem( project popup                   )
  1432. .rem(=================================)
  1433. .pent(project,project, )
  1434. A file with the extension .HPJ, that contains options that 
  1435. specifies how a help file is to be built.  Required by the 
  1436. help compiler.
  1437. .end
  1438. .rem(=================================)
  1439. .rem( RTF popup                       )
  1440. .rem(=================================)
  1441. .pent(RTF,RTF, )
  1442. Rich Text Format, a standard text file formatting standard. An 
  1443. RTF file consists of .p(rtfcmds,RTF commands) and normal text.
  1444. .end
  1445. .rem(=================================)
  1446. .rem( RTF commands popup              )
  1447. .rem(=================================)
  1448. .pent(rtfcmds,RTF commands, )
  1449. Special commands in an .p1(RTF) file that describe how text is to be 
  1450. displayed.  These commands start with a backslash (\\) character.
  1451. .end
  1452. .rem(=================================)
  1453. .rem( help compiler popup             )
  1454. .rem(=================================)
  1455. .pent(hlpcmplr,help compiler, )
  1456. The program that creates a help (.HLP) file from the .RTF file, 
  1457. using the rules detailed in the .HPJ file.
  1458. .end
  1459. .rem(=================================)
  1460. .rem( toolbar popup                   )
  1461. .rem(=================================)
  1462. .pent(toolbar,toolbar, )
  1463. The line of graphical push buttons that are located directly 
  1464. below HelpGen's menu bar.
  1465. .end
  1466. .rem(=================================)
  1467. .rem( title bar popup                 )
  1468. .rem(=================================)
  1469. .pent(titlebar,title bar, )
  1470. The area at the top of the HelpGen program window that contains 
  1471. the program name, file name, system menu button and window size 
  1472. controls.
  1473. .end
  1474. .rem(=================================)
  1475. .rem( topic popup                     )
  1476. .rem(=================================)
  1477. .pent(topic,topic, )
  1478. A block of text in a help file that will be displayed as a single 
  1479. display page.
  1480. .end
  1481. .rem(=================================)
  1482. .rem( popup popup                     )
  1483. .rem(=================================)
  1484. .pent(popup,popup, )
  1485. A small window that appears when you select a topic with a dotted 
  1486. underline.  The window will remain until you click the left mouse 
  1487. button again.
  1488. .end
  1489. .rem(=================================)
  1490. .rem( twips popup                     )
  1491. .rem(=================================)
  1492. .pent(twips,twips, )
  1493. A 20th of a point.  There are 72 points in an inch, so there 
  1494. are 1440 twips in an inch.
  1495. .end
  1496. .rem(=================================)
  1497. .rem( End of HelpGen macro file       )
  1498. .rem(=================================)
  1499. .end_file
  1500.